home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
AGA Toolkit '97
/
The AGA Toolkit '97.iso
/
os
/
sysreplacement
/
switchwindow
/
switchwindow.doc
< prev
next >
Wrap
Text File
|
1996-09-07
|
30KB
|
1,253 lines
SwitchWindow alpha version - BOOPSI ENVIRONMENT
* ALPHA VERSION ALPHA VERSION ALPHA VERSION ALPHA VERSION ALPHA VERSION
* This document DOES not reflect the current state of SwitchWindow.
* This document based on the docs created for SwitchWindow external release
* 1.1, with few changes.
* All class docs are up to date, but some contents have been removed
* (dots ...).
* This is external release 1.2, internal known as 1.52.
Be warned: This version is only for testing, not for standard use.
Please do not copy this version.
This version may crash your machine at any time, with unexpected results.
An object-oriented window tool based on the idea of Commodore's
IHelp && FKey.
To be used with Kickstart 3.x, written by Roland 'Gizzy' Mainz, freeware,
all rights reserved.
No guarantee is made of any kind is made that the programm described below
in this document is 100% reliable. You use this material on your own risk.
=========================== Introduction ==================================
===========================================================================
SwitchWindow is an object-oriented window managing tool with a powerful
AREXX port.
You may move, size or zoom any window you have specified via hotkey, mouse
or REXX, create screens, windows and other GUI elements like gadgets, menus
or icondropboxes and connect all these objects together.
========================= System Requirements =============================
===========================================================================
SwitchWindow requires an Amiga with at least 1M of memory. AmigaOS 3.0 or
later is also required.
SwitchWindow will take round about 200k space including code, default
objects and dynamic memory.
SwitchWindow is currently only tested on my private Amiga (Amiga 2000C,
M68030/68882, 1MB Chip, 16MB Fast, 425MB Nexus HD, OS 3.1 //
Amiga 1200 2MB Chip, 16M Fast, 68030/68882 50MHZ, SCSI 1.2GB, OS 3.0).
There will be also a AmigaOS 2.0 version, but currently I have not enough
time to invest in it.
============================= Known BUGS ==================================
===========================================================================
- Requires much memory (allocates large pages of memory for fast execution).
- Does not work properly at low mem conditions, this affects:
- Startup Initalisation:
The stringtag database (stringtagclass) won't hold the whole supported
tags. May cause deadlocks.
- String conversion:
- Results like strings won't appear.
- String to TagItem (stringtagclass) conversion won't work properly.
- Requesters (ASL etc.) won't appear (not really a bug).
- Enforcer hits
- Deadlocks while using datatypes objects
=========================== Installation ==================================
===========================================================================
1. Workbench
Drop the 'SwitchWindow' icon and it's contents in your favorite drawer
(like "Sys:WBStartup" or "Sys:Tools/Commodities"). If you'd put it into
SYS:WBStartup be sure that the tooltype "DONOTWAIT=TRUE" is set, otherwise
the Workbench will stop processing/executing any other icon in this drawer
until SwitchWindow ends (after a short time the WB will call you with a
requester).
2. CLI/Shell
Drop/Copy the 'SwitchWindow' file in your favorite directory (like
"SYS:Tools/Commodities").
If you like to run the program at startup, get your favorite editor and add
this line to S:user-startup (do NOT modify the S:startup-sequence !):
run <>nil: Sys:Tools/Commodities/SwitchWindow startup=REXX:swstartup.sw
3. CBM's Installer utility
Double-click on the Install-SwitchWindow icon.
========================== AREXX Interface ================================
===========================================================================
Since SwitchWindow's first release I've changed the whole AREXX Interface.
In SW's new model, AREXX ports are now represented as objects.
You can call any object, set or get any of it's attributes and so on.
If you want to send commands from an AREXX script to SW, you must tell
AREXX how to find SW's REXX port. This is done with the AREXX 'ADDRESS'
command.
example: ADDRESS 'SW.1'
========================= Object Class Reference ==========================
===========================================================================
All objects described here are based on the BOOPSI (Basic object-oriented
programming interface for intuition) and TagItems from utility.library,
both introduced with AmigaDos V36.
AREXX Command Reference
-----------------------
projectclass related commands
=============================
switchwindow/PROJECT.cmd
NAME
PROJECT -- Create or modify a project
FORMAT
PROJECT [NAME <projectname>] [APPLICATIONNAME <applicationname>]
[PORTBASENAME <rexxport basename>] [PORTNAME <rexxport name>]
[PORTPRI <number>] [MOVESTEP <number>] [SIZESTEP <number>]
[STARTUP <scriptname>] [LOCALE <locale prefs file]
[GUIDE <amigaguide document>] [PUBSCREEN <public screen name>]
[NOGUI] [NEW] [DISPOSE] [PROMPT]
TEMPLATE
NAME/K,APPLICATIONNAME/K,PORTBASENAME/K,PORTNAME/K,PORTPRI/K/N,
MOVESTEP/K/N,SIZESTEP/K/N,STARTUP/K,LOCALE/K,GUIDE/K,PUBSCREEN/K,NOGUI/S,
NEW/S,DISPOSE/S,PROMPT/S
FUNCTION
Create or modify a projectclass object. After creation add a
rexxportclass object.
RESULT
SEE ALSO
CLOSE.cmd, QUIT.cmd
switchwindow/HELP.cmd
NAME
HELP -- get help information for an object
FORMAT
HELP [COMMAND|OBJECT <object>] [CONTINOUS <bool>] [PROMPT]
TEMPLATE
COMMAND=OBJECT/K,CONTINOUS/K,PROMPT/S
FUNCTION
RESULT
switchwindow/CLOSE.cmd
NAME
CLOSE -- Close current project.
FORMAT
CLOSE [FORCE]
TEMPLATE
FORCE/S
FUNCTION
Do set PROJECTA_DONE with the current project (projectclass object).
RESULT
SEE ALSO
QUIT.cmd, PROJECT.cmd
switchwindow/QUIT.cmd
NAME
QUIT -- Quit whole application.
FORMAT
QUIT [FORCE]
TEMPLATE
FORCE/S
FUNCTION
Closes all projects and terminate the application.
RESULT
SEE ALSO
CLOSE.cmd, PROJECT.cmd
Object Related Commands
=======================
switchwindow/DISPOSEOBJECT.cmd
NAME
DISPOSEOBJECT -- Delete an object.
FORMAT
DISPOSEOBJECT [NAME|OBJECT] <objectname> [CLASS <class>]
TEMPLATE
NAME=OBJECT/A,CLASS/K
FUNCTION
Delete the named object. CLASS/K forces that only an object of the
specified class will be deleted.
RESULT
ERROR_OBJECT_IN_USE
ERROR_OBJECT_NOT_FOUND
ERROR_OBJECT_LINKED
switchwindow/SETATTR.cmd
NAME
SETATTR -- Set an object's attribute.
FORMAT
SETATTR [NAME|OBJECT] <objectname> [CLASS <class>] [FIELD <tagname>]
[STEM <taglist>] [VAR <data>]
TEMPLATE
NAME=OBJECT,CLASS/K,FIELD/K,STEM/K,VAR/K
FUNCTION
Set an object attributes.
When FIELD/K is given, only the specified attribute is modified.
Some attributes requiere more information (STEM/K than VAR/K).
When only STEM/K is given, this is the name of a taglist like this
'setattr class=gadgetclass object=mybutton stem=STEM'
STEM.0.TI_TAG = "GA_ID",
STEM.0.TI_DATA = 10;
STEM.1.TI_TAG = "GA_Text";
STEM.1.TI_DATA = "Button Text";
STEM.2.TI_TAG = "TAG_DONE";
STEM.2.TI_DATA = NULL;
Be carefull. Only a valid taglist should be given, terminated by
"TAG_DONE" or "TAG_MORE", while STEM.x.TI_DATA is the name of
another stem var.
There's currently a limit of 256 tags per list, but this will be
removed. You may change this limit by STEM.COUNT = 100; witch increase
the limit up to 100 tags per list.
RESULT
ERROR_OBJECT_NOT_FOUND
SEE ALSO
GETATTR.cmd
switchwindow/GETATTR.cmd
NAME
GETATTR -- get an object's attribute
FORMAT
GETATTR [NAME|OBJECT] <objectname> [CLASS <class>] [FIELD <tagname>]
[STEM <taglist>] [VAR <storage>]
TEMPLATE
NAME=OBJECT,CLASS/K,FIELD/K,STEM/K,VAR/K
FUNCTION
Get an attribute from an object. See upstairs for more information
RESULT
ERROR_OBJECT_NOT_FOUND
SEE ALSO
SETATTR.cmd
switchwindow/ADDMEMBER.cmd
NAME
ADDMEMBER -- Add an object to another.
FORMAT
ADDMEMBER [MASTER] <mastername> [MEMBER] <membername>
[MASTERCLASS <class>] [MEMBERCLASS <class>] [PROMPT]
TEMPLATE
MASTER/A,MEMBER,MASTERCLASS/K,MEMBERCLASS/K,PROMPT/S
FUNCTION
SEE ALSO
REMMEMBER.cmd
switchwindow/REMMEMBER.cmd
NAME
REMMEMBER -- Remove an object from its master.
FORMAT
REMMEMBER [MASTER] <mastername> [MEMBER] <membername>
[MASTERCLASS <class>] [MEMBERCLASS <class>] [PROMPT]
TEMPLATE
MASTER/A,MEMBER,MASTERCLASS/K,MEMBERCLASS/K,PROMPT/S
FUNCTION
SEE ALSO
ADDMEMBER.cmd
switchwindow/DISABLE.cmd
NAME
DISABLE -- Disable an object.
FORMAT
DISABLE [NAME|OBJECT] <objectname> [CLASS <class>]
TEMPLATE
NAME=OBJECT,CLASS/K,PROMPT/S
FUNCTION
Disables an object of following classes:
gadgetclass datatypesclass
cxclass cxfilterclass cxtranslateclass brokerclass
rexxportclass
RESULT
ERROR_ACTION_NOT_KNOWN
ERROR_OBJECT_NOT_FOUND
SEE ALSO
ENABLE.cmd, SETATTR.cmd
switchwindow/ENABLE.cmd
NAME
ENABLE -- Enable an object.
FORMAT
ENABLE [NAME|OBJECT] <objectname> [CLASS <class>]
TEMPLATE
NAME=OBJECT,CLASS/K,PROMPT/S
FUNCTION
Enables an object of following classes:
gadgetclass datatypesclass
cxclass cxfilterclass cxtranslateclass brokerclass
rexxportclass
RESULT
ERROR_ACTION_NOT_KNOWN
ERROR_OBJECT_NOT_FOUND
SEE ALSO
DISABLE.cmd, SETATTR.cmd
Commodities-Related Commands
============================
switchwindow/BROKER.cmd
NAME
BROKER -- Create or modify a commodities broker object.
FORMAT
BROKER [NAME|OBJECT] <object> [BROKERA_NAME <brokername>]
[BROKERA_TITLE <title>] [BROKERA_DESCR|BROKERA_DESCRIPTION <description>]
[CXA_PRIORITY <number>] [CX_DISABLED <bool>] [BROKERA_DOUNIQUE <bool>]
[BROKERA_DOSHOWHIDE <bool>] [ICA_TARGET <target>] [NEW] [PROMPT]
TEMPLATE
NAME=OBJECT,BROKERA_NAME/K,BROKERA_TITLE/K,
BROKERA_DESCR=BROKERA_DESCRIPTION/K,CXA_PRIORITY/K/N,
CXA_DISABLED/K,BROKERA_DOUNIQUE/K,BROKERA_DOSHOWHIDE/K,
ADDMEMBER/K,REMMEMBER/K,ICA_TARGET/K,NEW/S,PROMPT/S
FUNCTION
Creates or modify a brokerclass object.
BROKERA_NAME/K is the cx name in the commodities broker list.
BROKERA_DESCR/K is the cx description in the commodities broker list.
BROKERA_TITLE/K is the cx title in the commodities broker list.
CXA_PRIORITY/K/N priority in the commodities broker list.
CXA_DISABLED/K Object should be disabled (args are TRUE or FALSE).
BROKERA_DOUNIQUE/K Determine if broker's cx_name should be unique in
cx brojerlist or not (args are TRUE or FALSE).
BROKERA_DOSHOWHIDE/K Determine if broker should send BROKERA_SHOWGUI tags or not
(args are TRUE or FALSE).
ADDMEMBER/K add this object into object's memberlist
(attach this object (cxclass) to this broker)
REMMEMBER/K remove this object from object's memberlist
(attach this object (cxclass) to this broker)
ICA_TARGET/K target object (see icclass)
switchwindow/HOTKEY.cmd
NAME
HOTKEY -- Create or modify a commodities hotkey object.
FORMAT
HOTKEY [NAME|OBJECT] <objectname> [FILTER|KEY <cxfilterstring>]
[REPLACE <cxreplacestring>] [BROKER|MASTER <masterobject>]
[CMD|ICA_TARGET|TARGET <objectname>] [NEW] [PROMPT]
TEMPLATE
NAME=OBJECT,FILTER=KEY/K,REPLACE/K,BROKER=MASTER/K,
CMD=ICA_TARGET=TARGET/K,NEW/S,PROMPT/S
FUNCTION
Create a cxfilterclass and a connected cxtranslateclass object for
filtering or replacing an input action.
FILTER/K should be a valid commodities filter string description.
RELACE/K should be a valid commodities replace string description.
Both cxfilterclass and cxtranslateclass object get the same name.
If you want to access them seperately, use the CLASS/K key in those
commands (CLASS="cxfilterclass" / CLASS="cxtranslateclass").
SEE ALSO
CXFILTER.cmd, CXTRANSLATE.cmd, BROKER.cmd
switchwindow/CXFILTER.cmd
NAME
CXFILTER -- Create or modify a cxfilterclass object.
FORMAT
CXFILTER [NAME|OBJECT] <objectname> [FILTER|KEY <cxfilterstring>]
[BROKER|MASTER <masterobject>] [CMD|ICA_TARGET|TARGET <objectname>]
[NEW] [PROMPT]
TEMPLATE
NAME=OBJECT,FILTER=KEY/K,BROKER=MASTER/K,
CMD=ICA_TARGET=TARGET/K,NEW/S,PROMPT/S
FUNCTION
Create a cxfilterclass object for filtering an input action.
FILTER/K should be a valid commodities filter string description.
SEE ALSO
HOTKEY.cmd, CXTRANSLATE.cmd, BROKER.cmd
switchwindow/CXTRANSLATE.cmd
NAME
CXTRANSLATE -- Create or modify a cxtranslateclass object.
FORMAT
CXTRANSLATE [NAME|OBJECT] <objectname> [REPLACE <cxreplacestring>]
[MASTER <masterobject>] [NEW] [PROMPT]
TEMPLATE
NAME=OBJECT,REPLACE/K,MASTER/K,NEW/S,PROMPT/S
FUNCTION
Create a cxtranslateclass object for replacing an input action.
REPLACE/K should be a valid commodities filter string description.
SEE ALSO
HOTKEY.cmd, CXFILTER.cmd, BROKER.cmd
REXX-Related Commands
=====================
switchwindow/REXXPORT.cmd
NAME
REXXPORT -- Create or modify a public rexxport (rexxportclass object).
FORMAT
REXXPORT [NAME|OBJECT] <objectname> [PORTNAME] <portname>
[PORTPRI <value>] [NEW] [PROMPT]
TEMPLATE
NAME=OBJECT,PORTNAME/K,PORTPRI/K/N,NEW/S,PROMPT/S
FUNCTION
Create or modify a rexxportclass object.
PORTNAME/K object's name which appears in public port list
PORTPRI/K/N object's priority in public port list
You may change public port name and/or public port list priority
at runtime. All queuing msgs will be preserved.
SEE ALSO
LEARN.cmd
switchwindow/LEARN.cmd
NAME
LEARN -- Start/stop or modify logging all actions by a REXXPORT object.
FORMAT
LEARN [FILE <filename>] [START] [STOP] [PORTNAME <portname>]
[NAME|OBJECT <portobject>]
TEMPLATE
FILE/K,START/S,STOP/S,TIMESTAMP/S,NOHEADER/S,NORESULTS/S,PORTNAME/K,
NAME=OBJECT/K
FUNCTION
Log all actions at this port.
There may be more than one log active.
FILE/K Filename of the log. (Defaults to con://///auto/wait/close/inactive)
START/S start logging
STOP/S stops logging
PORTNAME/K name of the public port name
NAME=OBJECT/K object name
SEE ALSO
REXXPORT.cmd
BUGS
Currently 'LEARN STOP' will stop learning/logging the first job started.
Will be fixed.
Gadget-Related Commands
=======================
switchwindow/BUTTON.cmd
NAME
BUTTON -- Create or modify a button gadget.
TEMPLATE
NAME=OBJECT,WINDOW/K,LEFT/K/N,TOP/K/N,WIDTH/K/N,HEIGHT/K/N,TEXT/K,
IMAGE/K,ENDREQUESTER=GA_ENDGADGET/S,GA_TOGGLESELECT/S,GA_SELECTED/S,
CMD=ICA_TARGET/K,NEW/S,PROMPT/S
FUNCTION
switchwindow/PROPGADGET.cmd
NAME
PROPGADGET -- Create or modify a proportiornal slider.
TEMPLATE
NAME=OBJECT,WINDOW/K,LEFT/K/N,TOP/K/N,WIDTH/K/N,HEIGHT/K/N,PGA_TOP/K/N,
PGA_VISIBLE/K/N,PGA_TOTAL/K/N,PGA_FREEDOM/K,CMD=ICA_TARGET/K,
NEW/S,PROMPT/S
FUNCTION
switchwindow/STRINGGADGET.cmd
NAME
STRINGGADGET -- Create or modify a string entry field.
TEMPLATE
NAME=OBJECT,WINDOW/K,LEFT/K/N,TOP/K/N,WIDTH/K/N,HEIGHT/K/N,
STRING=STRINGA_TEXTVAL/K,VALUE=STRINGA_LONGVAL/K/N,STRINGA_MAXCHARS/K/N,
CMD=ICA_TARGET/K,NEW/S,PROMPT/S
FUNCTION
switchwindow/TEXTGADGET.cmd
NAME
TEXTGADGET -- Create or modify a string display field
TEMPLATE
NAME=OBJECT,WINDOW/K,LEFT/K/N,TOP/K/N,WIDTH/K/N,HEIGHT/K/N,
STRING=STRINGA_TEXTVAL/K,VALUE=STRINGA_LONGVAL/K/N,NEW/S,PROMPT/S
FUNCTION
Datatypes-Related Commands
==========================
switchwindow/DATATYPES.cmd
NAME
DATATYPES -- Create or modify a datatypes object.
TEMPLATE
NAME=OBJECT,WINDOW/K,LEFT/K/N,TOP/K/N,WIDTH/K/N,HEIGHT/K/N,
FILE=FILENAME/K,CLIPBOARD/S,CLIPUNIT/K/N,FONTNAME/K,FONTSIZE/K/N,
STEM/K,CMD=ICA_TARGET/K,NEW/S,PROMPT/S
FUNCTION
ICClass Commands
================
switchwindow/INTERCONNECTION.cmd
NAME
INTERCONNECTION -- Create or modify an icclass object.
TEMPLATE
NAME=OBJECT,CMD=ICA_TARGET/K,ICA_MAP=MAPSTEM/K,NEW/S,PROMPT/S
FUNCTION
switchwindow/MODEL.cmd
NAME
MODEL -- Create or modify a modelclass object.
TEMPLATE
NAME=OBJECT,CMD=ICA_TARGET/K,ICA_MAP=MAPSTEM/K,ADDMEMBER/K,REMMEMBER/K,
NEW/S,PROMPT/S
FUNCTION
switchwindow/GETATTRSCONNECTION.cmd
NAME
GETATTRSCONNECTION -- Create or modify a getattrsclass object.
TEMPLATE
NAME=OBJECT,CMD=ICA_TARGET/K,ICA_MAP=MAPSTEM/K,GETATTRSA_SOURCEOBJECT/K,
GETATTRSA_GETATTRTAGLIST/K,NEW/S,PROMPT/S
FUNCTION
Image related commands
======================
switchwindow/FRAMEICLASS.cmd
NAME
FRAMEICLASS -- Create or modify a frame image.
TEMPLATE
NAME=OBJECT,LEFT/K/N,TOP/K/N,WIDTH/K/N,HEIGHT/K/N,IA_FRAMETYPE/K,
NEW/S,PROMPT/S
FUNCTION
requesterclass related commands
===============================
switchwindow/REQUESTER.cmd
NAME
REQUESTER -- Create or modify a Intuition requester.
TEMPLATE
NAME=OBJECT,WINDOW/K,LEFT=RELLEFT/K/N,TOP=RELTOP/K/N,WIDTH/K/N,
HEIGHT/K/N,IMAGE/K,TITLE/K,DMREQUEST/S,POINTREL/S,REQUEST=SETDMREQUEST/S,
ENDREQUEST=CLEARDMREQUEST/S,NEW/S,PROMPT/S
FUNCTION
windowclass related commands
============================
switchwindow/WINDOW.cmd
NAME
WINDOW -- Create or modify a window.
TEMPLATE
NAME=OBJECT,OPEN/S,CLOSE/S,SNAPSHOT/S,ACTIVATE/S,MIN/S,MAX/S,FRONT/S,
BACK/S,LEFTEDGE/K/N,TOPEDGE/K/N,WIDTH/K/N,HEIGHT/K/N,SIZEGADGET/K,
CLOSEGADGET/K,PUBSCREEN/K,TITLE/K,SCREENTITLE/K,WA_IDCMP/K,ICA_TARGET/K,
STEM/K,NEW/S,PROMPT/S
FUNCTION
Window-Related Commands
=======================
switchwindow/MOVEWINDOW.cmd
NAME
MOVEWINDOW -- Move a window to the specified coordinates.
FORMAT
MOVEWINDOW [LEFTEDGE <number>] [TOPEDGE <number>] [WINDOW <pattern>]
[PUBSCREEN <pubscreenname>]
TEMPLATE
LEFTEDGE/K/N,TOPEDGE/K/N,WINDOW/K,PUBSCREEN/K
FUNCTION
"MOVEUPWINDOW"
"MOVEDOWNWINDOW"
"MOVELEFTWINDOW"
"MOVERIGHTWINDOW"
"MOVEPAGEUPWINDOW"
"MOVEPAGEDOWNWINDOW"
"MOVEPAGELEFTWINDOW"
"MOVEPAGERIGHTWINDOW"
switchwindow/SIZEWINDOW.cmd
NAME
SIZEWINDOW -- Change the window's box.
FORMAT
SIZEWINDOW [WIDTH <number>] [HEIGHT <number>] [WINDOW <pattern>]
[PUBSCREEN <pubscreenname>]
TEMPLATE
WIDTH/K/N,HEIGHT/K/N,WINDOW/K,PUBSCREEN/K
FUNCTION
SIZEUPWINDOW
SIZEDOWNWINDOW
SIZELEFTWINDOW
SIZERIGHTWINDOW
SIZEPAGEUPWINDOW
SIZEPAGEDOWNWINDOW
SIZEPAGELEFTWINDOW
SIZEPAGERIGHTWINDOW
SEE ALSO
intuition.library/SizeWindow()
switchwindow/CHANGEWINDOW.cmd
NAME
CHANGEWINDOW -- Change a window's box in position and dimensions.
FORMAT
CHANGEWINDOW [LEFTEDGE <number>] [TOPEDGE <number>] [WIDTH <number>]
[HEIGHT <number>] [WINDOW <pattern>] [PUBSCREEN <pubscreenname>]
TEMPLATE
LEFTEDGE/K/N,TOPEDGE/K/N,WIDTH/K/N,HEIGHT/K/N,WINDOW/K,PUBSCREEN/K
FUNCTION
switchwindow/WINDOWTOFRONT.cmd
NAME
WINDOWTOFRONT -- Bring a window to the front.
FORMAT
WINDOWTOFRONT [WINDOW <pattern>] [PUBSCREEN <pubscreenname>]
TEMPLATE
WINDOW/K,PUBSCREEN/K
FUNCTION
SEE ALSO
WINDOWTOBACK.cmd, intuition.library/WindowToFront()
switchwindow/WINDOWTOBACK.cmd
NAME
WINDOWTOBACK -- Send a window behind all others.
FORMAT
WINDOWTOBACK [WINDOW <pattern>] [PUBSCREEN <pubscreenname>]
TEMPLATE
WINDOW/K,PUBSCREEN/K
FUNCTION
SEE ALSO
WINDOWTOFRONT.cmd, intuition.library/WindowToBack()
switchwindow/WINDOWINFRONTOF.cmd
NAME
WINDOWINFRONTOF -- Future usage.
FORMAT
WINDOWINFRONTOF [WINDOW] <pattern> [BEHINDWINDOW] <pattern>
[PUBSCREEN <publicscreenname>]
TEMPLATE
WINDOW/A,BEHINDWINDOW/A,PUBSCREEN/K
FUNCTION
SEE ALSO
WINDOWTOFRONT.cmd, WINDOWTOBACK.cmd,
intuition.library/MoveWindowInFrontOf()
switchwindow/WINDOWTOMOUSE.cmd
NAME
WINDOWTOMOUSE
FORMAT
WINDOWTOMOUSE [WINDOW <pattern>] [PUBSCREEN <pubscreenname>]
TEMPLATE
WINDOW/K,PUBSCREEN/K
FUNCTION
switchwindow/MOUSETOWINDOW.cmd
NAME
MOUSETOWINDOW -- Move the mousepointer to a windows left top edge.
FORMAT
MOUSETOWINDOW [WINDOW <pattern>] [PUBSCREEN <pubscreenname>]
TEMPLATE
WINDOW/K,PUBSCREEN/K
FUNCTION
BUGS
Not fully implemented yet.
switchwindow/WINDOWTOSCREENCLIP.cmd
NAME
WINDOWTOSCREENCLIP -- Move a window into the current visible clip of the
screen.
FORMAT
WINDOWTOSCREENCLIP [WINDOW <pattern>] [PUBSCREEN <pubscreenname>]
TEMPLATE
WINDOW/K,PUBSCREEN/K
FUNCTION
switchwindow/SCREENCLIPTOWINDOW.cmd
NAME
SCREENCLIPTOWINDOW -- Make the specified window visible.
FORMAT
SCREENCLIPTOWINDOW [WINDOW <pattern>] [PUBSCREEN <pubscreenname>]
TEMPLATE
WINDOW/K,PUBSCREEN/K
FUNCTION
SEE ALSO
ScreenPosition( SPOS_MAKEVISIBLE, ... )
switchwindow/ACTIVATEWINDOW.cmd
NAME
ACTIVATEWINDOW -- Make a window active and useable.
FORMAT
ACTIVATEWINDOW [WINDOW <pattern>] [PUBSCREEN <pubscreenname>]
TEMPLATE
WINDOW/K,PUBSCREEN/K
FUNCTION
Brings the specified window to front, unzoomes and activates it.
SEE ALSO
intuition.library/ActivateWindow()
switchwindow/ZOOMWINDOW.cmd
NAME
ZOOMWINDOW -- Zooms a window between two fixed sizes.
FORMAT
ZOOMWINDOW [WINDOW <pattern>] [PUBSCREEN <pubscreenname>] [TOGGLE]
TEMPLATE
WINDOW/K,PUBSCREEN/K,TOGGLE/S
FUNCTION
SEE ALSO
intuition.library/ZipWindow()
switchwindow/UNZOOMWINDOW.cmd
NAME
UNZOOMWINDOW -- Unzoom a window.
FORMAT
UNZOOMWINDOW [WINDOW <pattern>] [PUBSCREEN <pubscreenname>]
TEMPLATE
WINDOW/K,PUBSCREEN/K
FUNCTION
Programmable Requesters
=======================
switchwindow/REQUESTFILE.cmd
NAME
REQUESTFILE -- Create an ASL file requester.
FORMAT
REQUESTFILE [DRAWER|PATH <path>] [FILE <filename>] [PATTERN <string>]
[TITLE <string>] [POSITIVE <string>] [NEGATIVE <string>]
[ACCEPTPATTERN <pattern>] [REJECTPATTERN <pattern>] [SAVEMODE|MULTISELECT]
[DRAWERSONLY] [NOICONS] [LEFTEDGE <number>] [TOPEDGE <number>]
[WIDTH <number>] [HEIGHT <number>] [PUBSCREEN <pubscreenname>]
[STEM <storage>]
TEMPLATE
DRAWER=PATH/K,FILE/K,PATTERN/K,TITLE/K,POSITIVE/K,NEGATIVE/K,
ACCEPTPATTERN/K,REJECTPATTERN/K,DOSAVEMODE=SAVEMODE/S,
DOMULTISELECT=MULTISELECT/S,DRAWERSONLY/K,REJECTICONS=NOICONS/S,
LEFTEDGE/K/N,TOPEDGE/K/N,WIDTH/K/N,HEIGHT/K/N,PUBSCREEN/K,STEM/K
FUNCTION
SEE ALSO
asl.library/AslRequest()
switchwindow/REQUESTFONT.cmd
NAME
REQUESTFONT -- Create an ASL font requester.
FORMAT
REQUESTFONT [FONTNAME|FONT <fontname>] [FONTSIZE|SIZE <fontsize>]
[TITLE <string>] [POSITIVE <string>] [NEGATIVE <string>]
[MINFONTHEIGHT <value>] [MAXFONTHEIGHT <value>] [ONLYFIXEDWIDTH]
[FRONTPEN <number>] [BACKPEN <number>] [ITALIC] [BOLD] [PLAIN]
[UNDERLINED] [REQUESTFRONTCOLOR] [REQUESTBACKCOLOR] [REQUESTDRAWMODE]
[REQUESTSTYLES] [DRAWMODESTEM <storage>] [LEFTEDGE <value>]
[TOPEDGE <value>] [WIDTH <value>] [HEIGHT <value>]
[PUBSCREEN <pubscreename>]
TEMPLATE
FONTNAME=FONT/K,FONTSIZE=SIZE/K/N,TITLE/K,POSITIVE/K,NEGATIVE/K,
MINFONTHEIGHT/K/N,MAXFONTHEIGHT/K/N,ONLYFIXEDWIDTH/S,FRONTPEN/K/N,
BACKPEN/K/N,MAXFRONTPEN/K/N,MAXBACKPEN/K/N,ITALIC/S,BOLD/S,PLAIN/S,
UNDERLINED/S,DOFRONTPEN=REQUESTFRONTCOLOR/S,DOBACKPEN=REQUESTBACKCOLOR/S,
DODRAWMODE=REQUESTDRAWMODE/S,DOSTYLE=REQUESTSTYLES/S,DRAWMODESTEM/K,
DRAWMODE/K/N,LEFTEDGE/K/N,TOPEDGE/K/N,WIDTH/K/N,HEIGHT/K/N,
PUBSCREEN/K,STEM/K
FUNCTION
SEE ALSO
asl.library/AslRequest()
switchwindow/REQUESTSCREENMODE.cmd
NAME
REQUESTSCREENMODE -- Create an ASL screenmode requester.
TEMPLATE
TITLE/K,POSITIVE/K,NEGATIVE/K,LEFTEDGE/K/N,TOPEDGE/K/N,WIDTH/K/N,
HEIGHT/K/N,PUBSCREEN/K,INFO/S,INFOLEFTEDGE/K/N,INFOTOPEDGE/K/N,
DISPLAYID/K/N,SCREENWIDTH/K/N,SCREENHEIGHT/K/N,SCREENDEPTH/K/N,
AUTOSCROLL/S,OVERSCANTYPE/K,DOWIDTH=REQUESTWIDTH/S,
DOHEIGHT=REQUESTHEIGHT/S,DODEPTH=REQUESTDEPTH/S,
DOOVERSCANTYPE=REQUESTOVERSCANTYPE/S,DOAUTOSCROLL=REQUESTAUTOSCROLL/S,
MINSCREENWIDTH/K/N,MAXSCREENWIDTH/K/N,MINSCREENHEIGHT/K/N,
MAXSCREENHEIGHT/K/N,MINSCREENDEPTH/K/N,MAXSCREENDEPTH/K/N
FUNCTION
SEE ALSO
asl.library/AslRequest()
switchwindow/REQUESTPUBSCREEN.cmd
NAME
REQUESTPUBSCREEN -- future
FORMAT
REQUESTPUBSCREEN [TITLE <string>] [DEFAULT <string>] [LEFTEDGE <value>]
[TOPEDGE <value>] [WIDTH <value>] [HEIGHT <value>]
[PUBSCREEN <pubscreenname>] [FONTNAME|FONT <fontname>]
[FONTSIZE|SIZE <fontsize>]
TEMPLATE
TITLE/K,DEFAULT/K,LEFTEDGE/K/N,TOPEDGE/K/N,WIDTH/K/N,HEIGHT/K/N,
FONTNAME=FONT/K,FONTSIZE=SIZE/K/N,PUBSCREEN/K
FUNCTION
BUGS
Not implemented yet.
switchwindow/REQUESTSTRING.cmd
NAME
REQUESTSTRING -- future
FORMAT
REQUESTSTRING [TITLE <string>] [PROMPT|TEXT <text>]
[DEFAULT|STRING <string>] [LEFTEDGE <value>] [WIDTH <value>]
[HEIGHT <value>] [TOPEDGE <value>] [PUBSCREEN <pubscreenname>]
[FONTNAME|FONT <fontname>] [FONTSIZE|SIZE <fontsize>]
TEMPLATE
TITLE/K,PROMPT=TEXT/K,DEFAULT=STRING/K,LEFTEDGE/K/N,TOPEDGE/K/N,
WIDTH/K/N,HEIGHT/K/N,PUBSCREEN/K,FONTNAME=FONT/K,FONTSIZE=SIZE/K/N
FUNCTION
BUGS
Not implemented yet.
switchwindow/REQUESTNUMBER.cmd
NAME
REQUESTNUMBER -- future
FORMAT
REQUESTNUMBER [TITLE <string>] [PROMPT|TEXT <string>]
[DEFAULT|NUMBER <value>] [MIN <value>] [MAX <value>]
[LEFTEDGE <value>] [TOPEDGE <value>] [WIDTH <value>] [HEIGHT <value>]
[PUBSCREEN <pubscreenname>] [FONTNAME|FONT <fontname>]
[FONTSIZE|SIZE <value>]
TEMPLATE
TITLE/K,PROMPT=TEXT/K,DEFAULT=NUMBER/K/N,MIN/K/N,MAX/K/N,LEFTEDGE/K/N,
TOPEDGE/K/N,WIDTH/K/N,HEIGHT/K/N,PUBSCREEN/K,FONTNAME=FONT/K,
FONTSIZE=SIZE/K/N
FUNCTION
BUGS
Not implemented yet.
switchwindow/REQUESTCHOICE.cmd
NAME
REQUESTCHOICE
FORMAT
REQUESTCHOICE [TITLE <string>] [TEXT <string>] [SYMBOLS <string>]
[PUBSCREEN <pubscreenname>]
TEMPLATE
TITLE/K,TEXT/K,SYMBOLS/K,PUBSCREEN/K
FUNCTION
BUGS
Did not respect PUBSCREEN/K yet.
switchwindow/REQUESTRESPONSE.cmd
NAME
REQUESTRESPONSE
FORMAT
REQUESTRESPONSE [TITLE <string>] [TEXT <string>] [POSITIVE <string>]
[NEGATIVE <string>] [PUBSCREEN <pubscreenname>]
TEMPLATE
TITLE/K,TEXT/K,POSITIVE/K,NEGATIVE/K,PUBSCREEN/K
FUNCTION
BUGS
Did not respect PUBSCREEN/K yet.
switchwindow/REQUESTNOTIFY.cmd
NAME
REQUESTNOTIFY
FORMAT
REQUESTNOTIFY [TITLE <string>] [TEXT <string>] [PROCEED <string>]
[PUBSCREEN <pubscreenname>]
TEMPLATE
TITLE/K,TEXT/K,PROCEED/K,PUBSCREEN/K
FUNCTION
BUGS
Did not respect PUBSCREEN/K yet.
Execution related commands
--------------------------
switchwindow/SHELLEXEC.cmd
NAME
SHELLEXEC
TEMPLATE
NAME=OBJECT,STRING/K,INPUTFILE/K,OUTPUTFILE/K,ERRORFILE/K,ASYNCH/S,USERSHELL/S,
CUSTOMSHELL/K,STACK/K/N,PRIORITY=PRI/K/N,NEW/S,PROMPT/S
FUNCTION
switchwindow/WBEXEC.cmd
NAME
WBEXEC -- execute a programm/project like from workbench
TEMPLATE
NAME=OBJECT,ICONNAME/K,PRIORITY=NP_PRIORITY/K/N,STACKSIZE=NP_STACKSIZE/K/N,
NEW/S,PROMPT/S
FUNCTION
Miscellaneous Commands
======================
switchwindow/BEEPSCREEN.cmd
NAME
BEEPSCREEN
FORMAT
BEEPSCREEN [PUBSCREEN <pubscreenname>]
TEMPLATE
PUBSCREEN/K
FUNCTION
switchwindow/NOP.cmd
NAME
NOP
FORMAT
NOP
TEMPLATE
,
FUNCTION
=============================== TODO ======================================
===========================================================================
This is an alpha version.
Anything will change, anything will move.
Be aware.
============================== SOURCE =====================================
===========================================================================
This is an alpha version.
Source is under construction.
Source is available by the author (restricted).
Source will be included in the external 2.0 version (freeware ??).
*** There MUST NOT exist a pre-2.0 version with source in the public.
*** If there is one, send me a mail. Illegal owners will be eaten. :-)
*** This also applies to mpeg.datatype (a mpeg system stream player
*** datatype, which is currently under construction).
=========================== Author's Request ==============================
===========================================================================
By releasing this program I do not place any obligations on you,
feel free to share this program with your friends (and enemies).
If you want to blame me, report any bugs, or wants a new version
send your letter to:
Roland Mainz
Hohenstaufenstraße 8
52388 Nörvenich
GERMANY
EMAIL is also available:
If you don't find a file "email.changed" in this archieve,
my email address is:
mainz@mats.gmd.de
Sorry, but I can only look once a month for mails.
The entire "SwitchWindow" package may be noncommercially redistributed,
provided that the package is always distributed in it's complete form
(including it's documentation). A small copy fee for media costs is okay
but any kind of commercial distribution is strictly forbidden!
Comments and suggestions how to improve this program are generally
appreciated!
Thanks to Matt Dillon for his DICE, and Olaf 'Olsen' Barthel for his
help, ideas and some text clips from his documentations.